home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
The 640 MEG Shareware Studio 2
/
The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO
/
wp
/
dtsrc112.zip
/
README.DTS
< prev
next >
Wrap
Text File
|
1992-05-25
|
20KB
|
440 lines
May 25, 1992
d t S e a r c h 1.12
How to install dtSearch:
* If you have the registered version, please follow the
directions in the manual.
* If you have the shareware version, there may be included
an "INSTALL.EXE" file. This just creates a directory to
hold the dtSearch program files and executes the self-
extracting archive file DTSRCH.EXE. If you have
INSTALL.EXE, you can use it to install dtSearch. If not,
just unpack the files into a directory on your hard disk.
dtSearch includes the following files:
File Name Purpose of File:
------------ ---------------------------------------------------
DTSEARCH.DOC Printable copy of the dtSearch manual
DTSEARCH.EXE The dtSearch program
DTSEARCH.HLP The hypertext help database for dtSearch
DTSEARCH.MNU A menu data file for dtSearch
DTS_SAFE.MNU An alternative menu data file for dtSearch
DTSEARCH.NOI List of "noise" words for dtSearch
DTSEARCH.REG A screen data file for dtSearch (registered
version only)
DTSEARCH.SCR A screen data file for dtSearch
ORDER.DTS Registration information and order form
README.DTS Important last-minute information
SITELICE.DTS Site license information and agreement
UPGRADE.DTS Version history and upgrade information
VENDOR.DTS Information and restrictions for disk vendors,
distributors, BBS sysops, user groups, etc.
- 2 -
Upgrade Information
From version 1.0:
Document indexes and setup files created with dtSearch 1.0
will not work properly with version 1.12. Although version
1.12 can read indexes created with version 1.0, using
version 1.12 to search for documents in an index created
with version 1.0 may result in incorrect words being
highlighted as "hits" when documents are retrieved.
Therefore, if you are upgrading from version 1.0, you should
delete all of the version 1.0 files and indexes and reindex
your documents.
From version 1.1 or version 1.11:
Version 1.12 is compatible with versions 1.1 or 1.11. You
can upgrade to version 1.12 by simply installing the files
from this version into your DTSEARCH directory. Do not
delete the existing dtSearch files.
If you are a registered user of an earlier version of
dtSearch, you do not have to register version 1.12. You can
simply install the shareware version of dtSearch 1.12 in
your DTSEARCH directory. The only difference between the
shareware version of dtSearch and the registered version is
the DTSEARCH.REG file, which suppresses the registration
reminder screen. The DTSEARCH.REG file included in your
registered dtSearch package will work with version 1.12.
Therefore, all you have to do to upgrade is to install the
new version of dtSearch in your DTSEARCH directory.
Some very minor changes in the way dtSearch counts words in
documents were made in version 1.12. If you notice that
dtSearch is highlighting the wrong words as hits when it
displays a retrieved document, you should delete your
existing indexes and reindex your documents with version
1.12. Most users should not need to do this.
- 3 -
dtSearch 1.12
Supplemental Documentation
May 25, 1992
A. Tips for faster indexing
* Give dtSearch as much conventional memory as you can.
dtSearch is designed to be able to run with very little
memory available -- as little as 384k. However, it runs
most efficiently with plenty of memory.
* Use a hard disk cache, such as Central Point Software's
PC-CACHE or Microsoft's SMARTDRV.SYS. A hard disk cache is
a program that makes your hard disk seem faster by storing
recently-used data in memory so it can be accessed again
quickly. dtSearch runs much faster with a hard disk cache.
B. DESQview Support
Use the following DESQview parameters to run dtSearch in a
DESQview window:
Memory Size (in K): 384
Options:
Writes text directly to screen.........: [N]
Displays graphics information..........: [N]
Virtualize text/graphics (Y,N,T).......: [Y]
Uses serial ports (Y,N,1,2)............: [N]
Requires floppy diskette...............: [N]
C. Limited Access Menu
dtSearch 1.12 includes an alternative menu file
DTS_SAFE.MNU, which only allows users to perform indexed searches
and view the results of searches. The purpose of the limited
access menu is to provide a way for network administrators and
bulletin-board operators to give their users simplified and
limited access to document indexes. To run dtSearch using this
menu, enter the command:
DTSEARCH /MENU DTS_SAFE.MNU
This menu will allow users to: (1) perform indexed searches; (2)
view results of prior searches; (3) create search reports; (4)
select index libraries; and (5) print the contents of a window.
Indexing features, the notepad editor, directory browsing, and
unindexed searches are unavailable to a user running dtSearch
with this menu.
- 4 -
D. The NOT and NOT W/N search connectors
(NOTE: This section supplements Chapter 6 of the User's Manual,
which describes search requests.)
You can use NOT in front of any search expression to reverse
its meaning. This allows you to exclude documents from a search.
For example,
apple sauce AND NOT pear
would retrieve documents containing the phrase "apple sauce" and
not containing the word "pear". Alternatively, you could search
for
NOT pear
and retrieve all documents that did not contain the word "pear".
Other examples:
apple OR NOT pear Retrieve documents that either (1)
contain the word "apple," or (2) do not
contain the word "pear".
NOT (apple w/5 pear)
Retrieve documents that do not contain
the word "apple" within 5 words of the
word "pear". Note the use of
parenthesis to make the request
unambiguous.
The NOT W/ ("not within") operator allows you to search for a
word or phrase not in association with another word or phrase.
For example,
apple NOT W/20 pear
would search for instances of the phrase "apple" more than 20
words away from the word "pear". It will also retrieve files
containing "apple" with no instances of "pear".
Unlike the W/ operator, NOT W/ is not symmetrical. That is,
"apple NOT W/20 pear" is not the same as "pear NOT w/20 apple".
In the "apple NOT W/20 pear" request, dtSearch searches for the
word "apple" and excludes cases where "apple" is too close to the
word "pear". In the "pear NOT W/20 apple" request, dtSearch
searches for the word "pear" and excludes cases where "pear" is
too close to "apple".
- 5 -
E. Binary files
When dtSearch builds an index of a group of files, it
automatically detects and skips "binary" files such as executable
programs and data files that do not contain text. If a file uses
a word processor format that dtSearch does not recognize,
dtSearch may classify it as "binary."
If dtSearch finds any binary files during an indexing job,
dtSearch will display a message at the end of the job indicating
the number of binary files. The file INDEXLOG.TXT will list the
files. INDEXLOG.TXT is re-written each time an index is updated,
so binary files from previous indexing jobs will not be listed.
If you are using batch mode indexing, the .LOG file created from
your script will list the binary files.
You can tell dtSearch not to skip binary files by setting
the "Index binary files" option in the Options menu to "Yes."
F. New Error Messages
"Error reading WordPerfect file"
WordPerfect files occasionally become corrupted due to disk
problems or WordPerfect bugs. Prior versions of dtSearch
would sometimes crash if a corrupted WordPerfect file was
encountered while searching or indexing. In this version,
dtSearch checks for corruption in a WordPerfect file and
will display this message if it finds erroneous data.
Here are some steps you can take to repair a corrupt
WordPerfect file (make a backup copy of the original file
first!). (1) Retrieve the file into WordPerfect, scroll to
the end of the file, and save the document. Often,
WordPerfect will detect and remove the corrupt data.
However, you may also lose some text. (2) Try one of the
programs that claim to be able to repair damaged WordPerfect
files. One such program is WPMD, which is shareware. (3)
Get the most recent maintenance release of WordPerfect from
WordPerfect Corp. and try step (1).
"Warning: document contains more than 64,000 words"
dtSearch can handle documents up to 64,000 words long (about
300 double-spaced pages). If a document is longer than
that, dtSearch will stop searching or indexing after the
64,000th word and display this message. To suppress this
message, set the "Warning for too-long documents" option in
the Options menu to "No."
- 6 -
G. Batch Mode Indexing
Batch mode indexing allows you to create, update, and
compress a document index by running dtSearch from a batch file.
(For information about creating batch files, see your DOS
manual.) Batch mode indexing can be useful if, for example, you
want to perform a complex and time-consuming series of tasks
every night to update your indexes.
1. Overview
To set up a batch indexing job, first create a "script" that
lists the tasks that you want dtSearch to perform. A script is a
text file that lists a series of indexing commands that dtSearch
will carry out.
The easiest way to create a script is to use the "Create
Batch Script" option in the Index menu. When you select this
option, a dialog box will appear that is almost identical to the
"Update Index" dialog box. At the top of the box will be a line
where you can specify the name of the script you want to create.
Fill out the rest of the box exactly as you would if you
were updating an index. If you want to create a new index for
your batch job, use the "Create Index" section of the dialog box.
See the manual section on Indexing Documents for more information
about the options in the Create Batch Script dialog box.
When you are done setting up the indexing job, select the
"Create Script" button at the bottom of the dialog box to create
the batch script. dtSearch will then store all of the
information you have provided (the index to update, the
directories to index, etc.) in a script file that you can run
later.
To run the script that you created, exit dtSearch and type
the following at the DOS prompt:
DTSEARCH /SCRIPT MYSCRIPT.JOB
where "MYSCRIPT.JOB" is the name of your script. dtSearch will
then perform the indexing task you specified. dtSearch will
record any errors encountered during the job in a file called
MYSCRIPT.LOG. Errors will not be displayed on the screen, since
dtSearch assumes that batch jobs will run without someone
watching them. After a batch indexing job, you should check the
log file to see if any errors occured.
This is all that you need to know to set up basic batch
indexing tasks. The rest of this section provides information
for more advanced use of batch mode indexing.
- 7 -
2. Script files
A script file is any text file that dtSearch can read. You
can create a script using the "Create Batch Script" option in the
Index menu, or you can create a script by hand. Before you try
to write your own scripts, you may want to create an example
using the "Create Batch Script" function so you can see what a
batch script looks like.
A script can be ASCII text or it can be in one of the word
processor formats that dtSearch recognizes, such as WordPerfect
or WordStar. The first line of a script must consist of the
words DTSEARCH SCRIPT.
A script consists of a series of "SET" statements that
specify the documents to be indexed and the index to use, and
commands such as "ADD" and "COMPRESS". dtSearch ignores any line
beginning with a *, so you can include comments in a script.
Here is an example:
DTSEARCH SCRIPT
* Add documents from C:\DOCS
SET INDEXNAME = MyIndex
SET DOCPATH = C:\DOCS
SET FILTER = *.DOC *.TXT *.WPF
ADD
COMPRESS
This script would index documents in the directory C:\DOCS,
storing information about the documents in the index called
"MyIndex", and would compress the index. To run this script, put
it in the file UPDATE.JOB and execute the command:
DTSEARCH /SCRIPT UPDATE.JOB
dtSearch will then execute the script, logging any error messages
to the file UPDATE.LOG.
3. Creating an index
To create an index, set up a script like this:
SET INDEXNAME = MyIndex
SET INDEXPATH = C:\DOCINDEX
CREATE
The two SET statements tell the program what you want to call the
index and the directory you want to put it into. The "CREATE"
statement tells dtSearch to create the index in the specified
directory.
- 8 -
WARNING: Please be careful when using CREATE. If you create an
index that already exists, dtSearch will delete the old index and
create a new, empty index in its place. In interactive mode, you
will get a warning message before this happens, but in batch mode
dtSearch simply assumes that you really want to create a new
index.
4. Adding documents to an index
To add documents to an index, use "SET DOCPATH =" to tell
dtSearch the directory in which the documents are located and
"SET FILTER =" to specify the file name filters. Then use the
"ADD" command to add the documents to the index. If you want to
index documents in several directories, use multiple
"SET DOCPATH =" statements separated by "ADD" commands. Example:
SET INDEXNAME = MyIndex
SET DOCPATH = C:\DOCS
SET FILTER = *.DOC *.TXT *.WPF
ADD
SET DOCPATH = C:\DOCS2
ADD
SET DOCPATH = C:\DOCS3
ADD
This would add documents from C:\DOCS, C:\DOCS2, and C:\DOCS3 to
the index "MyIndex".
The CREATE function needs to know both the name and the
directory for an index, and so both the SET INDEXNAME and the SET
INDEXPATH must be present to create an index. The ADD function
just needs to know which index you want to add documents to, so
you can use either the name (SET INDEXNAME) or the path (SET
INDEXPATH) to specify the index.
5. Reindexing changed documents
The REINDEX command in a script will cause dtSearch to
reindex any documents in an index that have been modified since
the index was last updated. This is the batch mode equivalent to
the "Reindex changed documents" menu option. Example:
SET INDEXNAME = MyIndex
REINDEX
- 9 -
6. Compressing an index
To compress an index, use SET INDEXNAME or SET INDEXPATH to
specify the index to compress and then use the COMPRESS command.
Example:
SET INDEXNAME = MyIndex
COMPRESS
7. Complex scripts
A script can do more than one indexing task. For example,
this script would create the index MyIndex, add documents to it,
compress it, and then create a second index:
SET INDEXNAME = MyIndex
SET INDEXPATH = c:\myindex
CREATE
SET DOCPATH = c:\docs
SET FILTER = *.doc *.wpf *.txt
ADD
COMPRESS
SET INDEXNAME = MyIndex II
SET INDEXPATH = c:\myindex2
CREATE
Note that you do not need to specify the index name again after
the CREATE command. dtSearch will remember the values given for
the previous command until you change them.